home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINPROGS / CATCHME.ZIP / MANUAL.TXT < prev    next >
Text File  |  1993-10-04  |  20KB  |  367 lines
  1. Program written by Jeff Nagle.  Manual written by Tony Magnusson.
  2.  
  3. CATCH⌐me does two things:
  4.         1. It lets you know the time and date without getting in your way.
  5.         2. It will ring an alarm, alerting you of anything from corporate
  6.            commitments to what day Saturday Night Live comes on.
  7.  
  8. The Task:
  9.         How does one write a program that tells you the time regardless of
  10.         the application you are using?
  11. The Answer:
  12.         Make the program "stay on top".
  13.  
  14. A good example of this is the Microsoft clock which has the ability to
  15. "stay on top".  The only drawback to this approach is when it is covering
  16. up something you want to access.  You know how annoying it is when you are
  17. always having to drag the clock around.  Now, imagine a little square,
  18. without a program name or a title or even buttons.  A square that only
  19. tells you the time and date. If it is covering up something all you have to
  20. do is touch it with your pointing device (mouse, etc.) and it "flies" away
  21. to some other location on your screen.  You can never "catch" CATCH⌐me.
  22. The bottom line is this: suppose CATCH⌐me is located over something you'd
  23. like to use, in whatever program you're working on.  Move your mouse as you
  24. normally would toward the intended area.  As soon as the mouse pointer is
  25. over the CATCH⌐me display it will move away allowing you to use whatever it
  26. was covering up.
  27.   
  28. In addition to this, you can set an alarm and note.  But how does one tell a
  29. program what to do when you can't "catch it"?  What you do is hold down
  30. either the right mouse button or the Shift key and drag the mouse pointer
  31. over the time display.  CATCH⌐me will stay in place and pop up the SetAlarm
  32. screen for you to set the alarm and note.  Click Okay when you're done.
  33.  
  34. CATCH⌐me supports the date and time formats available in the International
  35. dialog box time located in the Control Panel.  For instance, you can control
  36. whether the time is displayed in a 12 or 24 hour format using this dialog
  37. box.  The time is displayed in hours and minutes.  There are a couple of
  38. reasons why the seconds are not shown.  First, one of the design goals is to
  39. display only what absolutely must be shown.  Most people don't work by the
  40. second, except maybe lawyers.  I have yet to hear someone say "I'll call you
  41. at ten seconds past eight thirty."  The second reason is to reduce CATCH⌐me's
  42. impact on system performance as it is constantly running in the background.
  43. Since just the hours and minutes are shown the system clock needs to be
  44. checked only every 30 seconds in order to update the time display and check
  45. the alarm(s).  If seconds were displayed the system clock would have to be
  46. checked at least once every second.  This change from checking 2 times per
  47. minute to checking 60 times per minute represents an increase in required
  48. processor time of 3000%.  If you would like to have the seconds displayed
  49. please let me know.  If enough people request it I will make it an option
  50. in the next version.
  51.  
  52. INSTALLATION
  53.  
  54. Installation is the very easy.  The files VBRUN300.DLL and COMMDLG.DLL are
  55. needed for CATCH⌐me to start.  Both these files should be located in the
  56. Windows\System directory.  During installation about 150K worth of files
  57. will be copied to your Windows directory.  This will be reduced to 0K after
  58. installation.  The CATCH⌐me directory will take about 215K of disk space.
  59. No modifications are made to either the WIN.INI or SYSTEM.INI files unless
  60. you choose to have the WIN.INI file modified as described below in the
  61. section dealing with how to add CATCH⌐me to the "run=" line.  If, after
  62. installation, any of the support files in the CATCH⌐me program directory
  63. are also in the Windows\System directory then you should put the latest
  64. version in the Windows\System directory and delete the version in the
  65. CATCH⌐me program directory.  
  66.  
  67. CATCHME.EXE     Program file that gets copied to the program directory
  68. CATCHME.INI     Support file that gets copied to the program directory
  69. CMCONFIG.EXE    Program file that gets copied to the program directory
  70. CMDIALOG.VBX    Support file that gets copied to the program directory
  71. INSTSCRL.VBX    Support file that gets copied to the program directory
  72. THREED.VBX      Support file that gets copied to the program directory
  73. SETUPKIT.DL_    A file that's used for setup that stays on the floppy
  74. SETUP.EXE       A file that's used for setup that stays on the floppy
  75. CMSETUP.EX_     A file that's used for setup that stays on the floppy
  76. VER.DL_         A file that's used for setup that stays on the floppy
  77. STARTUP.INI     A file that's used for setup that stays on the floppy
  78. SETUP.LST       A file that's used for setup that stays on the floppy
  79. MANUAL.TXT      This file, gets copied to the program directory
  80.  
  81. Experienced computer users --
  82.         CATCH⌐me follows standard Windows Setup procedure.  Run the
  83.         Setup.Exe program and follow instructions.  Some of the files are
  84.         compressed so you must run SetUp in order to decompress these files.
  85.         To just copy them to the desired directories will not work.  Setup
  86.         will copy the new files into a specified directory.  You can then
  87.         delete or move the original files as desired.
  88.  
  89. The less experienced user --
  90.         I'm assuming that you've just got done extracting the "holding
  91.         file" (the ZIP file) for all the CATCH⌐me files.  You must run
  92.         SETUP.EXE because some of the files you unzipped are still in a
  93.         compressed form.  Before you run SETUP you need to decide where you want the program files located.  Most of the
  94.         files CATCH⌐me requires will be installed in it's own directory.  I
  95.         have a directory called C:\UTIL where I keep all my handy little
  96.         programs like CATCH⌐me.   Each program has its own subdirectory.  My
  97.         "path" would look like "C:\UTIL\CATCHME".
  98.  
  99.         There are two ways to run Setup, here's how:
  100.                 1.  From the File Manager select the directory the CATCH⌐me
  101.                     files in.  Double click on the Setup.Exe file.
  102.                 2.  Click the File Menu item either in File Manager OR in
  103.                     Program Manager.  Choose the "run" command and type
  104.                     in the path to where Setup.Exe is located, i.e.,
  105.                     C:\DOWNLOAD\Setup.Exe.  Click "Okay".
  106.  
  107.  
  108.         By default, CATCH⌐me will set itself up in a directory called
  109.         C:\CATCHME.  You can modify this simply by changing the dialog box
  110.         to say whatever you like.  As I mentioned earlier, I changed mine
  111.         to say C:\UTIL\CATCHME.  If you have not already created this
  112.         directory it will be created for you.  Next, Setup will want to know
  113.         how you plan to start CATCH⌐me.  There are three ways that all work
  114.         equally well.
  115.  
  116.         From an icon in a Program Group --
  117.                 This means that CATCH⌐me appears like every other program
  118.                 in Windows, as in icon in a Program Group.  To run
  119.                 CATCH⌐me, you double click on the icon and the program runs.
  120.                 Setup will give you the option to have CATCH⌐me installed in
  121.                 a new Program Group for itself, or to be part of an existing
  122.                 group.  Setup will present you with a list of all the
  123.                 Program Manager Groups that you have on your Desktop.
  124.                 Choose the "New Group" selection or any other group you wish
  125.                 from the list box.  Don't select either of the check boxes
  126.                 in the lower left.
  127.  
  128.         From the Startup Group(requires Windows 3.1 or above) --
  129.                 This group is like any other Program Manager group in that
  130.                 it appears on the Desktop like all the others but it has a
  131.                 special purpose.  Every time that you start Windows any
  132.                 programs whose icons are located in this group will start
  133.                 automatically without you having to do anything.  It is
  134.                 common to run utility programs such as CATCH⌐me from the
  135.                 Startup Group.  W